home *** CD-ROM | disk | FTP | other *** search
/ Night Owl 6 / Night Owl's Shareware - PDSI-006 - Night Owl Corp (1990).iso / 029a / swpr100.zip / SWAPPER.DOC next >
Text File  |  1991-10-03  |  3KB  |  102 lines
  1. SWAPPER 1.0
  2.  
  3. A simple program to Swap files in a configurable way.
  4. =====================================================
  5. By: Massimo Gentilini
  6.     Via Marco Polo 50
  7.     40131 BOLOGNA Italy
  8.     E-Mail: FidoNet      2:332/401
  9.             Compuserve   100016,3007
  10.             Bix          MaxGent
  11.  
  12. -----------------------------------------------------
  13.  
  14. 0) Introduction
  15.  
  16. The Swapper program is a program designed to copy a file randomly choosed
  17. from a list over another file. You can use it to change the background
  18. .BMP file of Windows each time that you boot your computer, to change the
  19. final image of your BBS each time that a user Logoff, to display a random
  20. choosed Gif image every time you boot your PC and so on, the possible uses
  21. are limited only by your imagination.
  22.  
  23. This program is different from other programs on the market because it allows
  24. you to give a different probability to be choosed to each file, so that
  25. you can use more often your preferred file and less often the others. This
  26. is achieved via a simple control file.
  27.  
  28.  
  29. 1) Usage
  30.  
  31. Usage of Swapper is really easy, simply give the following Dos command:
  32.  
  33. SWAPPER name_of_config_file output_file_name
  34.  
  35. the program will choose a random file from that listed in
  36. 'name_of_config_file' and will copy it over 'output_file_name'.
  37.  
  38. WARNING: output_file_name will be ALWAYS be deleted and overwritten,
  39. so be careful.
  40.  
  41. Examples:
  42.  
  43. Swapper config.ctl windows.bmp
  44. Swapper c:\bin\utils\ansi.ctl ansiwelc.ans
  45. Swapper c:\gif\gif_list.cfg c:\welcome.gif
  46.  
  47. The format of control file is the following:
  48.  
  49. ;---------------------------------------- cut here -------------
  50. ; A line that starts with a ; or a blank space is considered as
  51.   a comment. All the following filenames MUST start in the first
  52. ; column of file
  53. ; Format is
  54. ;
  55. ;   c:\pathname\filename weight
  56. ;
  57. ; Example
  58. ;
  59. NICEGIRL.GIF      4
  60. C:\GIF\WONDER.GIF 20
  61. D:\GIF\N5.GIF     30
  62. PRETTY.GIF        6
  63. ;---------------------------------------- End of file ---------
  64.  
  65. The pathname could be omitted, in this case Swapper will try to load
  66. file from current directory.
  67.  
  68. The weight indicates the probability of the file to be choosed. The higher
  69. is the number the higher is the probability. In the previous example
  70. if you start the program for 60 times (the sum of weights) the first
  71. file will be choosen 4 times, the second 20 and so on.
  72.  
  73. If you want that all file have the same probability simply put the same
  74. weight in all lines or leave it blank (in this case, or if the program
  75. will not be able to parse the number, a weight of 1 will be assumed).
  76.  
  77.  
  78. 2) Warranty
  79.  
  80. There is no warranty. I can only assure that the program was not a virus
  81. or a trojan horse when it left my home, with the following validate
  82. values:
  83.  
  84.           File Name:  swapper.exe
  85.                Size:  11,293
  86.                Date:  10-3-1991
  87. File Authentication:
  88.      Check Method 1 - B256
  89.      Check Method 2 - 0F7D
  90.  
  91. 3) Shareware
  92.  
  93. This is a Shareware program. If you like it and use it please send
  94. 10 dollars or more at the above address. Please send money or international
  95. checks, credit card and regular checks will not be processed.
  96.  
  97.  
  98. 4) Bug information and other request
  99.  
  100. Please feel free to contact me at one of the above addresses.
  101.  
  102.